home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / bootup / boot_a2m / beep / beep.doc next >
Text File  |  1995-05-02  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                   Beep
  9.  
  10.                            Copyright (C) 1990
  11.                             By David Baggett
  12.  
  13.  
  14. --------------------------------------------------------------------------------
  15.                              User Contract
  16.  
  17. This program is FREE.  You may distribute it at will, provided you
  18.  
  19.         1) do not charge any money for it,
  20.         2) distribute it WITH the documentation, and
  21.         3) do not change the program or documentation in ANY WAY.
  22.  
  23. --------------------------------------------------------------------------------
  24.  
  25.  
  26. Introduction  
  27. ------------
  28.  
  29.    In 1989, Dan Wilga released a Public Domain program called "newbell"
  30. that replaced the boring "ding" sound the ST makes with a digitized
  31. sound.  Unfortunately, newbell only allowed certain playback speeds, all of 
  32. which were incompatible with sounds sampled on the Mac.
  33.  
  34.    Here's a new program that does the same thing, but allows sample playback
  35. speed to be specified in Hertz.
  36.  
  37.  
  38. General Usage
  39. -------------
  40.  
  41.    Put beep.prg in your AUTO folder and create beep.inf with a standard
  42. ASCII text editor.  In beep.inf, put the name of the sample you want to
  43. replace the system beep with and the playback speed in Hertz for the sample.
  44. For example,
  45.  
  46. d:\usr\sounds\chbell.snd        8000
  47.  
  48. will replace the system beep with a church bell sample, played at 8000 Hertz.
  49.  
  50.  
  51. Enabling and Disabling Beep
  52. ---------------------------
  53.  
  54.    When beep.prg is invoked with no parameters, it reads the beep.inf
  55. file and loads all the sounds.  This typically occurs at bootup in the
  56. AUTO folder.  However, you can run beep.prg from a command shell (or
  57. from the desktop if you rename a copy beep.ttp) as well.  To turn
  58. Beep off, type
  59.  
  60.         beep off
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. from a command shell, or run beep.ttp from the desktop with parameter
  73. "off".
  74.  
  75.    Similary, type
  76.  
  77.         beep on
  78.  
  79. to turn Beep back on.
  80.  
  81.  
  82. Technical Information
  83. ---------------------
  84.  
  85.    Beep steals Bios trap #13 and looks for Bconout(2, 7) calls.  When it sees 
  86. one, it plays the sound.
  87.  
  88.    Beep uses the bit six of the CONTERM system global (the byte at location 
  89. $484) for enabling and disabling itself.  When the high bit is 1, Beep is on.
  90. When the hight bit is 0, Beep is off.  Whenever Beep is on it masks the normal
  91. system beep by clearing the appropriate bit in CONTERM.
  92.  
  93.    Beep is well-behaved and should work with all versions of TOS.  It does 
  94. not use any undocumented memory locations.
  95.  
  96.  
  97. Caveats
  98. -------
  99.  
  100.    It is a FEATURE that Beep does not turn off mouse interrupts when playing
  101. the sound.  (Otherwise you wouldn't be able to move the mouse until the
  102. sound finished playing.)  What this means, however, is that you can slow
  103. down the playback by jiggling the mouse around while it's playing.  Now 
  104. I don't want to hear any complaints about this, cause that's the way it's
  105. gotta be!
  106.  
  107.    Whenever you move the mouse, the processor is interrupted -- lots of
  108. times, in fact.  (Technically, once for each mouse pulse).  The playback 
  109. routine taxes the 68000 and so the slightest interruption will slow the
  110. playback down.  Ain't nothin' I can do about it.  'Nuff said.
  111.  
  112.    It's best to play samples at fairly low rates (e.g., 8000 or 11000 Hertz)
  113. so that you don't completely bog down the system.  Using samples at rates
  114. above 11000 will often prevent the mouse from tracking correctly while the
  115. sound is playing, and may cause weird things to happen to very CPU-intensive 
  116. applications.  (To see this effect, select the "About..." box in TOS 1.4 and
  117. click outside the dialog box with Beep on.)
  118.  
  119.    Since the program uses bit six of the CONTERM variable, there wil be
  120. problems if Atari decides to use this bit for something.  (Specifically,
  121. Beep will get turned off and on for no obvious reason.)  This is the only 
  122. way Beep may be incompatible with future versions of TOS.
  123.  
  124.    The program will not know it has already been installed if you
  125. run it twice (or ten times) in a row.  Doing so will use up more and
  126. more memory.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.